Skip to main content

Checar Ticket

Visão Geral​

Este bloco é utilizado para a integração com o TopDesk, permitindo a consulta de chamados já existentes na plataforma. Ele disponibiliza diferentes campos e informações de retorno conforme as configurações de autenticação.

Regras de Funcionamento​

  • Autenticação TOPdesk:

    • Desativada:
      • Obrigatório informar apenas o Número do chamado.
      • Exemplo: 'I2309-024'.
    • Ativada:
      • É necessário o preenchimento de Login e Senha ou ID Solicitante, além do Número do chamado.

  • Retorno:

    • Título do chamado
    • Descrição do chamado
    • Status do chamado
    • Quantidade de comentários (comentários feitos pelo operador)
    • Quantidade de anexos
    • Campos customizados (se foram utilizados na criação do ticket)

Campos Disponíveis​

Image 1

  • Número do chamado (obrigatório)
    • Exemplo: 'I2309-024'

Campos customizados​

Image 2

  • Campo API
    • Neste campo, você deve selecionar o campo da api que você criou na etapa de criar ticket.

Exemplo de uso:

  • Se na criação do ticket você utilizou o campo customizado topdesk.ticket.optionalFields2.text1 com o valor canal_usado, você pode configurar o bloco de Checar Ticket para retornar esse campo em uma variável.
  • No bloco seguinte, você pode acessar essa variável para verificar qual valor está armazenado nesse campo.

Retorno da API​

Image 3

Após a execução do bloco, as seguintes variáveis ficam disponíveis:

  • {topdesk.ticket.title} - Título do ticket
  • {topdesk.ticket.description} - Descrição do ticket
  • {topdesk.ticket.status} - Status do ticket
  • {topdesk.ticket.quantity_comments} - Quantidade de comentários (feitos pelo operador)
  • {topdesk.ticket.quantity_attachments} - Quantidade de anexos
  • {topdesk.error} - Erro da resposta (caso ocorra algum erro)

Observações Importantes​

  • Após a execução do bloco, você pode acessar as informações do chamado através das variáveis retornadas.
  • É possível retornar campos customizados que foram criados durante a criação do ticket.
  • O bloco se adapta dinamicamente conforme as opções e preenchimentos configurados.